home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms / ho5jx.zip / mnu.doc < prev    next >
Text File  |  1994-11-02  |  17KB  |  458 lines
  1.  
  2.  
  3.                     MNU  Manual          Page 1
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                         _______
  10.                    ____|__     |               (R)
  11.                 --|       |    |-------------------
  12.                   |   ____|__  |  Association of
  13.                   |  |       |_|  Shareware
  14.                   |__|   o   |    Professionals
  15.                 -----|   |   |---------------------
  16.                      |___|___|    Member
  17.  
  18.  
  19.  
  20.                 Version 2.11           September, 1994
  21.  
  22.  
  23.           HOMNU, or MNU, is a batch file enhancer and menu program.  Its
  24.           included with Hands On to help make the overall package easier
  25.           to use, and to show you how you can use the Hands On package
  26.           with your favourite menu program.
  27.  
  28.           The original version is distributed as TWSELECT, and you will
  29.           find various references to TWSELECT.  This version has been
  30.           renamed to avoid confusion because the two now have some
  31.           differences.  If your copy has some other name just mentally
  32.           substitute that name for 'MNU' and 'TWSELECT' as necessary.
  33.           The original source and .exe can likely still be found in the
  34.           Force area (GO FORCE) on Compuserve.  This version has full
  35.           ASP member support, and may still be distributed freely.
  36.  
  37.           We have a program where we gather donated computer equipment
  38.           from various sources, tune it, and add selected software (eg
  39.           emacs, microspell, some games, and a simple menu), then
  40.           distribute the results to individuals doing work for
  41.           non-profit groups.  This software meets our simple free
  42.           distribution requirements.  We also change it to produce
  43.           versions specifically for special needs.  All of the special
  44.           versions to date have been free on request.
  45.  
  46.           A caution:
  47.  
  48.           The documentation suggests various environment variables, all
  49.           starting with TW (Tom Woodgerd - the original author).  You
  50.           may use the environment for the purposes suggested here.
  51.           However, the environment is a limited resource and accidental
  52.           miss-use leads to various problems with all kinds of software,
  53.           so this version uses the MNU.INI file.  MNU looks for it in
  54.           the current directory and then the directory where the MNU.EXE
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                     MNU  Manual          Page 2
  61.  
  62.  
  63.  
  64.           resides.  The MNU.INI file format is as follows:
  65.  
  66.           # setup information for homnu/mnu
  67.           TWP=1012
  68.           TWID=
  69.           TWDR=C
  70.           TWH=Hands On Remote Access
  71.           USER=
  72.           TWCLR=
  73.           SP=
  74.           TWSAV=  Shareware is simply another software distribution medium
  75.           # <- these allow following comments on the same line
  76.  
  77.           You can have alternate .INI files that are copied to MNU.INI
  78.           inside your batch file to change the pertinent settings in
  79.           successive MNU menus.
  80.  
  81.  
  82.           MNU has 2 main modes:  ASK and MENU
  83.  
  84.  
  85.           ASK MODE is a simple way of asking for user input within a
  86.           batch file.  It displays the "input string" at the current
  87.           screen position and waits for a one key response.  Only keys
  88.           in the "key list" are allowed:
  89.  
  90.           MNU ASK <input string>  - The string to display
  91.              <key list>      - Keys that are acceptable responses
  92.              [DEFAULT=c]     - The default key if enter is pressed
  93.              [TIMEOUT=n]     - The number of seconds to wait
  94.              [DEBUG]         - Causes the errorlevel to be displayed
  95.              [NOTIME]        - Time remaining won't be displayed.
  96.  
  97.           Upon exit it sets the DOS Errorlevel based on the order of key
  98.           pressed.
  99.  
  100.           Example:  MNU ASK "<O>ki, <L>aser, <E>pson (press O, L, or
  101.           E):  " OLE
  102.  
  103.           After displaying "<O>ki, <L>aser, <E>pson (press O, L, or E):
  104.           " it waits for a keypress.If it's in the group (OLEole) it
  105.           sets the DOS Errorlevel according to the order in the key list
  106.           and exits.  Esc exits with 0.  Other options can be placed
  107.           after the key list:
  108.  
  109.           DEFAULT - This is used to set a Default Key, to be used if
  110.           Enter is pressed or a TIMEOUT is reached.  If "default=a" is
  111.           used, then when the user presses Enter, it would be the same
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                     MNU  Manual          Page 3
  118.  
  119.  
  120.  
  121.           as pressing "a".
  122.  
  123.           TIMEOUT - An example would be "timeout=30".  If no key is
  124.           pressed within 30 seconds the program will terminate.  If
  125.           there is a DEFAULT key set, it will act as if that key were
  126.           pressed.
  127.  
  128.           DEBUG - (or /debug) This shows the DOS Errorlevel upon exit.
  129.  
  130.           NOTIME - This prevents the time remaining from being displayed
  131.           when TIMEOUT is active.
  132.  
  133.  
  134.  
  135.           MENU MODE is used to paint a menu on screen and allow users to
  136.           select a choice by positioning a light bar, or letter, and
  137.           pressing enter.  Normally the menu is full screen but the NC
  138.           option reduces the menu to a minimum size.  This allows you to
  139.           stack successive menus, offset if you like, and to have the
  140.           menus pop up anywhere on the screen.  MENU MODE returns the
  141.           DOS errorlevel set to the sequence number of the item
  142.           selected.
  143.  
  144.  
  145.           MNU MENU <options list separated by commas or spaces>
  146.           [options]
  147.  
  148.           - MENU mode is used to pop up a list of menu choices.  When
  149.           the user selects one and presses "Enter", it sets the DOS
  150.           Errorlevel based on the order of the item chosen.
  151.  
  152.           Example:  MNU MENU "Oki Printer","Laser Printer","Epson
  153.           Printer"
  154.  
  155.           - A BOX will be displayed giving the options in a LIST.  The
  156.           user may choose an option using the up and down arrow keys and
  157.           then press enter.  It will set the DOS Errorlevel according to
  158.           the order of option chosen and then exit.
  159.  
  160.           - There is a DEBUG option.  If "debug" or "/debug" is placed
  161.           after the option list it will show the DOS Errorlevel upon
  162.           exit.
  163.  
  164.           - The LOCATION of the box can be controlled by setting an
  165.           environment variable.  Type the following at the command line
  166.           or in a batch file "set twp=1012".  This would set the upper
  167.           left corner of the box to row 10, column 12.  The coordinates
  168.           must contain 4 numbers.  For instance row 9, column 1 would be
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                     MNU  Manual          Page 4
  175.  
  176.  
  177.  
  178.           "set twp=0901". Row 0, column 0 would be "set twp=0000".  If
  179.           you use the MNU.INI file to set TWP you lose the capability to
  180.           'stack' successive menus offset like cards unless you put
  181.           different MNU.INI files in different subdirectories.
  182.  
  183.           - A title will be placed at the top of the menu box, if the
  184.           parameters include "t:title".
  185.  
  186.           Example:  MNU MENU "t:Printer Menu" "Oki" "Laser" "Epson"
  187.  
  188.           - To create overlaid menus, use "NC" as a parameter.  The
  189.           screen won't be cleared before popping up the new menu.  You
  190.           can also use NC to make minimal sized menus.
  191.  
  192.           Example:  MNU MENU "NC" "t:Printer Menu" "Oki" "Laser" "Epson"
  193.  
  194.           - You can set an environment variable (TWH) to over-ride the
  195.           default header of "Menu Choices".  If you rename MNU to HOMNU
  196.           the header becomes 'Hands On Remote Access' without using
  197.           environment space.
  198.  
  199.           Example:  SET TWH=ACME COMPANY MENU
  200.  
  201.           - You can set an environment variable (TWSAV) to cause the
  202.           screen to be cleared and your message (up to 60 characters) to
  203.           be displayed.  If you run out of environment space the message
  204.           will be truncated.
  205.  
  206.           Example:  SET TWSAV=I'm at Lunch.  Return 1:30
  207.  
  208.           The screen saver activates when you tap F7, and the screen is
  209.           restored when you tap another key.  You can also use the
  210.           command line parameter or switch -NOBURN to have the screen
  211.           saver automatically start up when the menu starts.
  212.  
  213.           MNU menu "t:Main Menu" "WordPerfect" "Lotus" "Games" "Quit" -NOBURN
  214.           # a sample startup with the -NOBURN option
  215.  
  216.           Releases before June, 1994 had a timed screen saver (akin to a
  217.           TSR or resident program inside the program), but it has been
  218.           disabled.  If you need a timed screen saver, and or password
  219.           capability yell.  Note that you can leave this screen saver
  220.           running while HOHOST is resident and waiting for a call, and
  221.           it will appear when the connection is completed.  This also
  222.           provides an initial menu of choices.
  223.  
  224.           Here's an entire batch file using MNU MENU MODE:
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                     MNU  Manual          Page 5
  232.  
  233.  
  234.  
  235.             @echo off
  236.             ** set twh=Acme Toys Inc.
  237.            :start
  238.             MNU menu "t:Main Menu" "WordPerfect" "Lotus" "Games" "Quit"
  239.             if errorlevel == 4 goto :end
  240.             if errorlevel == 3 goto :games
  241.             if errorlevel == 2 goto :lotus
  242.             if errorlevel == 1 goto :wp
  243.             goto :end
  244.            :wp
  245.             cd \wp51
  246.             wp
  247.             goto :start
  248.            :lotus
  249.             cd \123r24
  250.             123
  251.             goto :start
  252.            :games
  253.             call gamemenu
  254.             goto :start
  255.            :end
  256.  
  257.           - USAGE TRACKING:  If an environment variable called TWDR is
  258.           set, MNU will record all user menu selections in a DBASE III
  259.           type data file called ACTIONS.DBF.  "TWDR" needs to be like
  260.           "C:", "D:", "F:" etc.  ACTIONS.DBF will be opened or created
  261.           in the root directory of the drive specified by "TWDR".  It
  262.           will also record the setting for the environment variables:
  263.           "LANUSER" and "TWID" (up to 10 characters each).
  264.  
  265.           Example:  SET TWDR=C:
  266.  
  267.           If you prefer, you may use "SET TWDR=C" without the ":" and
  268.           the ACTIONS.DBF will be created and maintained in the 'home
  269.           directory' where the MNU.EXE resides.
  270.  
  271.           You can use the F4 function key to look at and edit the
  272.           entries in the ACTIONS.DBF when the feature is active in MNU.
  273.  
  274.           We have found that the ACTIONS.DBF can be damaged leading to
  275.           MNU locking up when it tries to access ACTIONS.DBF.  If MNU
  276.           locks up on you, then first try erasing ACTIONS.DBF
  277.  
  278.           - MONO MONITOR MODE:  If you're running this on a mono or LCD
  279.           monitor you'll want to set an environment variable TWCLR for
  280.           black & white screens.
  281.  
  282.           Example:  SET TWCLR=MONO
  283.  
  284.  
  285.  
  286.  
  287.  
  288.                     MNU  Manual          Page 6
  289.  
  290.  
  291.  
  292.           Support and Distribution:
  293.  
  294.           This product is partially Copyright (C) 1993-4 P. C. Softsmith
  295.           all rights reserved.  It is distributed with shareware and
  296.           should be distributed with this documentation.  It is normally
  297.           distributed with other P.C. Softsmith materials that further
  298.           explain the shareware process.  If you wish to distribute it
  299.           with your software or are unable to find the other
  300.           documentation that should accompany this file (such as the
  301.           SHR_WARE.DOC, FILE_ID.DIZ, and the VENDOR.DOC) please contact
  302.           whoever gave you the software or P.C. Softsmith.
  303.  
  304.  
  305.           For technical support, either call (604) 433-5189, or write to
  306.           Suite 606 - 6455 Willingdon Avenue, Burnaby, British Columbia,
  307.           Canada, V5H 4E4. You may also try leaving a Compuserve message
  308.           at 75020, 2664, or send email to
  309.  
  310.           INTERNET:vic_williams@mindlink.bc.ca
  311.  
  312.           You will likely be able to access us on the Vancouver FreeNet
  313.           in the near future.
  314.  
  315.           Portions (C) Copyright 1993-4 P. C. Softsmith all rights
  316.           reserved.
  317.  
  318.  
  319.           History:
  320.  
  321.           November 1, 1994 vw:  Version 2.20 added command line
  322.           -NOBURN.  September, 1994 vw:  Version 2.11 minor MNU.DOC
  323.           changes.
  324.  
  325.           June, 1994 - vw:  Version 2.1 Added MNU.INI, some minor
  326.           internal changes and changed the screen saver.  Main title
  327.           changes if .exe name changed to HOMNU.EXE.  This version
  328.           automatically tries to display an intelligent error message
  329.           when something goes wrong.
  330.  
  331.           May, 1994 - vw:  more interactive screen saver and some minor
  332.           tinkering.  Added the F4 EDIT with ACTIONS.DBF optionally in
  333.           the home directory replacing TWSELECT.DBF in the root
  334.           directory.
  335.  
  336.           December, 1993 vw:  Version 2
  337.           This product has been reworked somewhat from the original
  338.           TWSELECT for distribution with other public domain and freely
  339.           distributable materials.  We have a program where we gather
  340.  
  341.  
  342.  
  343.  
  344.  
  345.                     MNU  Manual          Page 7
  346.  
  347.  
  348.  
  349.           donated computer equipment from various sources, tune it, and
  350.           add selected software (eg emacs, microspell, some games, and a
  351.           simple menu), then distribute the results to individuals doing
  352.           work for non-profit groups.
  353.  
  354.           -This version has full ASP support, and may still be distributed
  355.           freely.  You can use us for free support.
  356.           -Added self detection of monochrome monitors.
  357.           -Moved help to separate .DOC file, for a smaller .exe and easier
  358.           maintenance.
  359.  
  360.  
  361.  
  362.           TWSELECT was written by Tom J. Woodgerd, using the FORCE
  363.           compiler.  It has been released into the public domain, to be
  364.           used freely.  The author provides no warranty or support, but
  365.           your comments and suggestions are welcome.
  366.  
  367.           Sept 11, 1992 - Tom J. Woodgerd, 1018 State St., Helena MT
  368.           59601.  You can leave messages on Worthy Computer BBS, (406)
  369.           443-7508.
  370.  
  371.           Sept 11, 1992 - TJW: Version 1.12
  372.           - Cleaned up the HELP screens and uploaded to several BBS's.
  373.           Worthy Computer, HUGE, FORCE BBS.
  374.           - Changed environment variable WPUSER to TWID.
  375.  
  376.           July 27, 1992 - TJW: Version 1.12
  377.           - Added mono capabitity.  Just "set twclr=mono".
  378.  
  379.           July 05, 1992 - TJW: Version 1.11
  380.           - Fixed bug in ASK.
  381.           - Changed USERNAME to LANUSER.
  382.           - Changed to not save history if errorlevel = 0.
  383.           - Added extra info to info screen (F1).
  384.  
  385.           June 29, 1992 - TJW: Version 1.10
  386.           - Changed to save all user selections to <twdr>\TWSELECT.DBF if
  387.           the environment variable "TWDR" is set to C: etc.
  388.  
  389.           June 26, 1992 - TJW: Version 1.09
  390.           - Changed to show time as hh:mm:ss.
  391.  
  392.           June 17, 1992 - TJW: Version 1.08
  393.           - Added Help Screen.  Added ability to display the TWSAV
  394.           message when in screen saver mode.
  395.  
  396.           June 15, 1992 - TJW: Version 1.07
  397.  
  398.  
  399.  
  400.  
  401.  
  402.                     MNU  Manual          Page 8
  403.  
  404.  
  405.  
  406.           - Unable to fix "timer_entry()" to not conflict with EXTRA!
  407.           and other tsrs.  The clock display and the screen saver now
  408.           only work if the environment variable "TWSAV" is set to "Y".
  409.  
  410.           June 13, 1992 - TJW: Version 1.06
  411.           - Fixed bug in "civilian" time display.
  412.  
  413.           June 10, 1992 - TJW: Version 1.05
  414.           - Added option to put the header in environment variable called TWP.
  415.           - Changed timeout to 10 minutes.
  416.  
  417.           May 26, 1992 - TJW: Version 1.04
  418.           - Changed lead in on menu items to "A. ", "B. ", etc.
  419.           - Changed menu header to use a box.
  420.  
  421.           May 13, 1992 - TJW: Version 1.03
  422.           - Added ability to jump to menu option when the first character
  423.           of the option is pressed.  Also got rid of automatic upper
  424.           casing on menu items.
  425.  
  426.  
  427.           P. C. Softsmith warranty information:
  428.  
  429.           THE DOCUMENTATION AND ASSOCIATED SOFTWARE ARE DISTRIBUTED AND
  430.           SOLD WITH NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING
  431.           ITS MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE.
  432.           THE INFORMATION IN THIS DOCUMENTATION IS SUBJECT TO CHANGE
  433.           WITHOUT NOTICE AND DOES NOT REPRESENT A COMMITTMENT ON THE
  434.           PART OF THE VENDOR.
  435.  
  436.           OTHER PRODUCT AND BRAND NAMES MENTIONED ARE TRADEMARKS OR
  437.           REGISTERED TRADEMARKS OF THEIR RESPECTIVE HOLDERS.
  438.           SPECIFICALLY XBASE IS THE GENERIC DATABASE INDUSTRY
  439.           REPLACEMENT FOR THE REGISTERED TERM DBASE OWNED BY BORLAND
  440.           INTERNATIONAL.
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.